<!-- ids in this section are gradually being converted
to something like 'prefs-mouse'.
remember to add an anchor for the old id in the right place -->
<!-- Maintained for 2.8 compatibility -->
<anchor id="goscustdesk-6"/>
<!-- Desktop Overview / Desktop Preferences -->
<anchor id="gosoverview-55"/>
<!-- ids of sections removed from this document for 2.14 -->
<anchor id="goscustdesk-10"/><!-- Customizing Your Panels -->
<highlights>
<para>This chapter describes how to use the preference tools to
customize the GNOME Desktop.</para>
</highlights>
<!-- move the following to its own section, "Using Pref Tools"? -->
<para>A preference tool is a small application that allows you to change settings in the GNOME Desktop. Each preference tool covers a particular aspect of your computer. For example, with the <application>Mouse</application> preference tool you can set your mouse to left-handed or right-handed use, or change the speed of the pointer on the screen. With the <application>Windows</application> preference tool you can set behaviour common to all windows such as the way in which you select them with the mouse.</para>
<para>To open a preference tool, choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu></menuchoice> in the top panel. Choose the tool that you require from the submenu.</para>
<para>With a few exceptions, the changes you make to settings in a preference tool take effect immediately, without needing to close the preference tool. You can keep the preference tool window open while you try the changes, and make further changes if you wish.</para>
<para>Some applications or system components may add their own preference tools to the menu.</para>
<note><para>Some preference tools let you modify essential parts of your system, and therefore require administrative access. When you open the preference tool, a dialog box will prompt you for your password. These are in the <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu></menuchoice> submenu. This menu also contains more complex utility applications for managing and updating your system.</para></note>
<sect1 id="prefs-personal">
<title>Personal</title>
<!-- Was Login Photo prefs, could go to About Me if that was enabled by default -->
<anchor id="goscustdesk-95"/>
<sect2 id="goscustaccess-11">
<title>Assistive Technologies Preferences</title>
<indexterm>
<primary>accessibility</primary>
<secondary>setting assistive technology
preferences</secondary>
</indexterm>
<indexterm>
<primary>preference tools</primary>
<secondary>Assistive Technologies</secondary>
</indexterm>
<para>Use the <application>Assistive Technologies</application> preference tool to enable assistive technologies
in the GNOME Desktop. You can also use the <application>Assistive Technology</application> preference tool to open other preference tools which contain preferences related to assistive technologies.</para>
<itemizedlist>
<listitem>
<para><guibutton>Preferred Applications</guibutton> lets you specify assistive technology applications to start automatically when you log in. See <xref linkend="prefs-preferredapps"/></para>
</listitem>
<listitem>
<para><guibutton>Keyboard Accessibility</guibutton> lets you configure keyboard accessibility features such as sticky keys, slow keys or bounce keys.
See <xref linkend="prefs-keyboard-a11y"/></para>
</listitem>
<listitem>
<para><guibutton>Mouse Accessibility</guibutton> lets you configure mouse accessibility features such as dwell clicking. See <xref linkend="goscustdesk-53"/></para>
</listitem>
</itemizedlist>
<para><xref linkend="goscustaccess-TBL-14"/> lists the assistive technology
<para>Select this option to enable assistive technologies
in the GNOME Desktop.</para>
<para>Note that for technical reasons, you have to log in
again after enabling this option for it to be fully effective.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="prefs-keyboard-shortcuts">
<title>Keyboard Shortcuts Preferences</title>
<!-- Maintained for 2.8 compatibility -->
<anchor id="goscustdesk-39"/>
<indexterm>
<primary>preference tools</primary>
<secondary>Keyboard Shortcuts</secondary>
</indexterm>
<indexterm>
<primary>shortcut
keys</primary>
<secondary>configuring</secondary>
</indexterm>
<indexterm>
<primary>keyboard shortcuts</primary>
<secondary>configuring</secondary>
</indexterm>
<para>Use the <application>Keyboard Shortcuts</application> preference tool to customize the default keyboard shortcuts to your requirements.</para>
<para>A <firstterm>keyboard shortcut</firstterm> is a key or combination of
keys that provides an alternative to standard ways of performing an action. For more on keyboard shortcuts, and a list of the default shortcuts in GNOME, see <xref linkend="keyboard-skills"/>.</para>
<para>To edit a keyboard shortcut, perform the following steps:</para>
<orderedlist>
<listitem><para>
Click the action in the list. If you are using the the keyboard, use the arrow keys to select the shortcut and press <keycap>Return</keycap>.</para></listitem>
<listitem>
<para>Press the new key or key combination you want to assign to the action.</para>
<para>To clear a shortcut, press <keycap>Backspace</keycap>. The action is now marked as <guilabel>Disabled</guilabel>.</para>
</listitem>
</orderedlist>
<para>To cancel assigning a shortcut, click elsewhere in the window or press <keycap>Escape</keycap>.</para>
<para>The shortcuts you can customize are grouped as follows:</para>
<variablelist>
<varlistentry><term>Desktop</term>
<listitem><para>These are general shortcuts for the whole desktop, such as logging out, <link linkend="lock-screen">locking the screen</link>, opening the <link linkend="menubar">panel menubar</link>, or launching a web browser.</para></listitem>
</varlistentry>
<varlistentry><term>Sound</term>
<listitem><para>Shortcuts for controlling your music player and the system volume.</para></listitem>
</varlistentry>
<varlistentry><term>Window Management</term>
<listitem><para>Shortcuts for working with windows and workspaces, such as maximizing or moving the current window, and switching to another workspace. For more information on these kinds of actions, see <xref linkend="windows-manipulating"/> and <xref linkend="overview-workspaces"/>.</para></listitem>
</varlistentry>
<varlistentry><term>Accessibility</term>
<listitem><para>Shortcuts for starting assistive technologies, such as
a screen reader, a magnifier or an on-screen keyboard.</para></listitem>
</varlistentry>
<varlistentry><term>Custom Shortcuts</term>
<listitem><para>Custom shortcuts that have been added with the <guilabel>Add</guilabel> button. This section will not be shown if there are no custom shortcuts.</para></listitem>
</varlistentry>
</variablelist>
<para>
To add a custom shortcut, use the <guilabel>Add</guilabel> button in the action area. You have to provide a name and a command for the new shortcut. The new custom shortcut will appear in the list of shortcuts and can be edited in the same way as the predefined shortcuts.
</para>
<para>
To remove a custom shortcut, use the <guilabel>Remove</guilabel> button.
</para>
</sect2>
<sect2 id="prefs-preferredapps">
<title>Preferred Applications</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<anchor id="goscustdoc-2"/>
<indexterm>
<primary>preference tools</primary>
<secondary>Preferred Applications</secondary>
</indexterm>
<indexterm>
<primary>default applications</primary>
<see>preferred applications</see>
</indexterm>
<para>Use the <application>Preferred
Applications</application> preference tool to specify the applications that
you want the GNOME Desktop to use when the GNOME Desktop starts an application
for you. For example, you can specify the web browser application (<application>Epiphany
<para>You can customize the preferences for the <application>Preferred Applications</application> preference tool in the following functional areas.</para>
<para>For each preferred application category, a drop-down menu contains a list of possible applications you can choose from. The list depends on the applications installed on your computer.</para>
<para>In each category, the last item in the menu (<guimenuitem>Custom</guimenuitem>) permits you to customize the command used by the system when the specific launch action occurs.</para>
<sect3 id="goscustlookandfeel-32">
<title>Custom Command Options</title>
<indexterm>
<primary>preferred applications</primary>
<secondary>custom command</secondary>
</indexterm>
<para>The following table summarizes the various options you can choose from when you select
<guimenuitem>Custom</guimenuitem> in the drop-down application menu.</para>
<para>Select this option to run the command as soon as your session begins. For more accessibility options, see <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
<para>A theme is a group of coordinated settings that specifies
the visual appearance of a part of the GNOME Desktop. You can choose themes
to change the appearance of the GNOME Desktop. Use the <application>Theme</application> tabbed section to select a theme. You can choose from a list
of available themes. The list of available themes includes several themes
for users with accessibility requirements. </para>
<para>A theme contains settings that affect different parts of the GNOME Desktop,
as follows:</para>
<variablelist>
<varlistentry>
<term>Controls</term>
<listitem>
<para><indexterm><primary>GTK+
themes</primary><see>themes, controls options</see></indexterm><indexterm><primary>themes</primary><secondary>controls options</secondary><tertiary>introduction</tertiary></indexterm>The controls setting for a theme determines
the visual appearance of windows, panels, and applets. The controls setting
also determines the visual appearance of the GNOME-compliant interface items
that appear on windows, panels, and applets, such as menus, icons, and buttons.
Some of the controls setting options that are available are designed for special
accessibility needs. You can choose an option for the controls setting from
the <guilabel>Controls</guilabel> tabbed section in the <guilabel>Customize Theme</guilabel> window.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Colors</term>
<listitem>
<para><indexterm><primary>themes</primary><secondary>color options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>color themes</primary><see>themes, color options</see></indexterm>The color setting for
a theme determines the color of various user interface elements. You can choose several pairs of colors fromt he <guilabel>Colors</guilabel> tabbed section in the <guilabel>Customize Theme</guilabel> window.</para>
<note><para>It is important to choose pairs of colors that have a good contrast with each other,
otherwise text may become hard to read.</para></note>
a theme determines the appearance of the frames around windows only. You can
choose an option for the window frame setting from the <guilabel>Window Border</guilabel> tabbed section in the <guilabel>Customize Theme</guilabel> window.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Icons</term>
<listitem>
<para><indexterm><primary>themes</primary><secondary>icons options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>icon themes</primary><see>themes, icons options</see></indexterm>The icon setting for a theme determines the appearance of
the icons on panels and the desktop background. You can choose an option for
the icon setting from the <guilabel>Icons</guilabel> tabbed section in the <guilabel>Customize Theme</guilabel> window.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Pointer</term>
<listitem>
<para><indexterm><primary>themes</primary><secondary>pointer options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>pointer themes</primary><see>themes, pointer options</see></indexterm>The pointer setting for a theme determines the appearance of
and sice of the mouse pointer. You can choose an options for the pointer setting fromthe <guilabel>Pointer</guilabel> tabbed section in the the <guilabel>Customize Theme</guilabel> window.</para>
</listitem>
</varlistentry>
</variablelist>
<sect4 id="goscustdesk-61">
<title>To Create a Custom Theme</title>
<para>The themes that are listed in the <guilabel>Theme</guilabel>
tabbed section are different combinations of controls options, window frame options,
and icon options. You can create a custom theme that uses different combinations
of controls options, window frame options, and icon options.</para>
<para>To create a custom theme, perform the following steps:</para>
<orderedlist>
<listitem>
<para>Start the <application>Appearance</application> preference tool.
Open the <guilabel>Theme</guilabel> tabbed section.</para>
</listitem>
<listitem>
<para>Select a theme in the list of themes.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Customize</guibutton> button. A <guilabel>Customize Theme</guilabel> dialog is displayed.</para>
</listitem>
<listitem>
<para>Select the controls option that you want to use in the custom
theme from the list in the <guilabel>Controls</guilabel> tabbed section. The
list of available controls options includes several options for users with
accessibility requirements.</para>
</listitem>
<listitem>
<para>Click on the <guilabel>Window Border</guilabel> tab to display
the <guilabel>Window Border</guilabel> tabbed section. Select the window frame
option that you want to use in the custom theme from the list of available
options. The list of available window frame options includes several options
for users with accessibility requirements.</para>
</listitem>
<listitem>
<para>Click on the <guilabel>Icons</guilabel> tab to display the <guilabel>Icons</guilabel> tabbed section. Select the icons option that you want to
use in the custom theme from the list of available options. The list of available
icons options includes several options for users with accessibility requirements.</para>
</listitem>
<listitem>
<para>Click <guibutton>Close</guibutton> to close the <guilabel>Customize Theme</guilabel> dialog.</para>
</listitem>
<listitem>
<para>On the <application>Appearance</application> preferences tool,
click on the <guibutton>Save As</guibutton> button. A <guilabel>Save Theme
As</guilabel> dialog is displayed.</para>
</listitem>
<listitem>
<para>Type a name and a short description for the custom theme in
the dialog, then click <guibutton>Save</guibutton>. The custom theme now appears
in your list of available themes.</para>
</listitem>
</orderedlist>
</sect4>
<sect4 id="goscustdesk-62">
<title>To Install a New Theme</title>
<para>You can add a theme to the list of available themes. The new theme must
be an archive file that is tarred and zipped. That is, the new theme must
be a <filename>.tar.gz</filename> file.</para>
<para>To install a new theme, perform the following steps:</para>
<orderedlist>
<listitem>
<para>Start the <application>Appearance</application> preference tool.
Open the <guilabel>Theme</guilabel> tabbed section.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Install</guibutton> button.
A file chooser dialog is displayed.</para>
</listitem>
<listitem>
<para>Enter the location of the theme archive file in the location
entry. Alternatively, select the theme archive file in the file list. When you have selected the file, click <guibutton>Open</guibutton>.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Install</guibutton> button to install
the new theme. </para>
</listitem>
</orderedlist>
</sect4>
<!--How does this work nowadays ?
<sect4 id="goscustdesk-80">
<title>To Install a New Theme Option</title>
<para>You can install new controls options, window frame options, or icons
options. You can find many controls options on the Internet.</para>
<para>To install a new controls option, window frame option, or icons option,
perform the following steps:</para>
<orderedlist>
<listitem>
<para>Start the <application>Appearance</application> preference tool.
Open the <guilabel>Theme</guilabel> tabbed section.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Customize</guibutton> button.
An <guilabel>Customize Theme</guilabel> dialog is displayed.</para>
</listitem>
<listitem>
<para>Click on the tab for the type of theme that you want to install.
For example, to install an icons option, click on the <guilabel>Icons</guilabel>
tab.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Install Theme</guibutton> button.
A <guilabel>Theme Installation</guilabel> dialog is displayed.</para>
</listitem>
<listitem>
<para>Enter the location of the option archive file in the drop-down
combination box. Alternatively, to browse for the file, click on the <guibutton>Browse</guibutton> button. When you have selected the file, click <guibutton>OK</guibutton>.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Install</guibutton> button to install
the new option. </para>
</listitem>
</orderedlist>
</sect4>
-->
<sect4 id="goscustdesk-81">
<title>To Delete a Theme Option</title>
<para>You can delete controls options, window frame options, or icons options.</para>
<para>To delete a controls option, window frame option, or icons option, perform
the following steps:</para>
<orderedlist>
<listitem>
<para>Start the <application>Appearance</application> preference tool.
Open the <guilabel>Theme</guilabel> tabbed section.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Customize</guibutton> button.
A <guilabel>Customize Theme</guilabel> dialog is displayed.</para>
</listitem>
<listitem>
<para>Click on the tab for the type of option that you want to delete. </para>
</listitem>
<listitem>
<para>Select the theme option you want to delete.</para>
</listitem>
<listitem>
<para>Use the <guibutton>Delete</guibutton> button to delete the
selected option. Note that you can not delete system-wide theme
options.</para>
</listitem>
</orderedlist>
</sect4>
</sect3>
<sect3 id="prefs-desktopbackground">
<title>Desktop Background Preferences</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<para>The <link linkend="overview-desktop">desktop</link> background is the image or color that is applied to your
desktop. You can open <guilabel>Background</guilabel> tabbed section in the <application>Appearance</application> preference tool by right-clicking on the desktop and choosing <guimenuitem>Change Desktop Background</guimenuitem>, as well as from the <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu></menuchoice> menu.</para>
<para>You can customize the desktop background in the following ways:</para>
<itemizedlist>
<listitem>
<para>Select an image for the desktop background. The image is superimposed
on the desktop background color. The desktop background color is visible if
you select a transparent image, or if the image does not cover the entire
desktop.</para>
</listitem>
<listitem>
<para>Select a color for the desktop background. You can select
a solid color, or create a gradient effect with two colors. A gradient effect
is a visual effect where one color blends gradually into another color. </para>
</listitem>
</itemizedlist>
<tip><para>You can also drag a color or a pattern to the desktop from the <link linkend="nautilus-backgrounds-and-emblems"><guilabel>Backgrounds
and Emblems</guilabel> dialog</link> in the <application>Nautilus</application> file manager.</para></tip>
<para><xref linkend="goscustdesk-TBL-14"/> lists the background preferences
<para>To specify how to display the image, select one of the following
options from the <guilabel>Style</guilabel> drop-down list:</para>
<itemizedlist>
<listitem>
<para><guilabel>Centered</guilabel>: Displays the image in the middle
of the desktop, respecting the image's original size.</para>
</listitem>
<listitem>
<para><guilabel>Fill Screen</guilabel>: Enlarges the image to cover
the desktop, altering its proportions if needed.</para>
</listitem>
<listitem>
<para><guilabel>Scaled</guilabel>: Enlarges the image until the
image meets the screen edges, and maintains the proportions of the image.</para>
</listitem>
<listitem>
<para><guilabel>Zoom</guilabel>: Enlarges the smaller dimension of the
image until it meets the screen edges; the image may be cropped in the other dimension.</para>
</listitem>
<listitem>
<para><guilabel>Tiled</guilabel>: Duplicates the original-sized image as
often as necessary and print the images next to another so as they entirely cover the desktop.</para>
</listitem>
</itemizedlist>
</entry>
</row>
<row>
<entry colname="colspec0" colsep="0" rowsep="0">
<para>
<guilabel>Add</guilabel>
</para>
</entry>
<entry colname="colspec1" colsep="0" rowsep="0">
<para/>
<para>Click on the <guibutton>Add</guibutton> to browse for
an image on your computer. A standard file selector will be presented. Choose
the image you want and click <guibutton>Open</guibutton>.</para>
</entry>
</row>
<row>
<entry colname="colspec0" colsep="0" rowsep="0">
<para>
<guilabel>Remove</guilabel>
</para>
</entry>
<entry colname="colspec1" colsep="0" rowsep="0">
<para>Choose the image that you want to remove,
then click <guilabel>Remove</guilabel>. This removes the image from the list of available wallpapers; however, it does not delete the image from your computer.
in the <guilabel>Style</guilabel> drop-down list, and the color
selector buttons.</para>
<para>You can specify a color scheme in one of the
following ways:</para>
<itemizedlist>
<listitem>
<para>Choose <guilabel>Solid color</guilabel> from the <guilabel>Background Style</guilabel> drop-down list to specify a single color for the
desktop background. </para>
<para>To choose the color that you require, click on the <guibutton>Color</guibutton> button. The <guilabel>Pick a Color</guilabel> dialog is displayed.
Choose a color, then click <guibutton>OK</guibutton>.</para>
</listitem>
<listitem>
<para>Choose <guilabel>Horizontal gradient</guilabel> from the <guilabel>Background Style</guilabel> drop-down list. This option creates a gradient
effect from the left screen edge to the right screen edge.</para>
<para>Click on the <guibutton>Left Color</guibutton> button to display the <guilabel>Pick a Color</guilabel> dialog. Choose the color that you want to appear at
the left edge.</para>
<para>Click on the <guibutton>Right Color</guibutton> button. Choose the color
that you want to appear at the right edge.</para>
</listitem>
<listitem>
<para>Choose <guilabel>Vertical gradient</guilabel> from the <guilabel>Background Style</guilabel> drop-down list. This creates a gradient effect
from the top screen edge to the bottom screen edge.</para>
<para>Click on the <guibutton>Top Color</guibutton> button to display the <guilabel>Pick a Color</guilabel> dialog. Choose the color that you want to appear at
the top edge.</para>
<para>Click on the <guibutton>Bottom Color</guibutton> button. Choose the
color that you want to appear at the bottom edge.</para>
</listitem>
</itemizedlist>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect3>
<sect3 id="prefs-font">
<title>Font Preferences</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<anchor id="goscustdesk-38"/>
<anchor id="goscustdesk-83"/>
<anchor id="goscustdesk-94"/>
<indexterm>
<primary>preference tools</primary>
<secondary>Font</secondary>
</indexterm>
<indexterm>
<primary>fonts</primary>
<secondary>desktop</secondary>
</indexterm>
<indexterm>
<primary>fonts</primary>
<secondary>applications</secondary>
</indexterm>
<indexterm>
<primary>fonts</primary>
<secondary>window title</secondary>
</indexterm>
<indexterm>
<primary>fonts</primary>
<secondary>terminal</secondary>
</indexterm>
<indexterm>
<primary>fonts</primary>
<secondary>rendering</secondary>
</indexterm>
<para>Use the <guilabel>Fonts</guilabel> tabbed section in the <application>Appearance</application> preference tool
to choose which fonts are used in different parts of the desktop, and the way in which fonts are displayed on the screen.</para>
<sect4 id="prefs-font-choose">
<title>Choosing Fonts</title>
<para>The font selector button shows the name of the font and its point size. The name is also shown in bold, italic, or regular type.</para>
<para>To change the font, click the font selector button. The font picker dialog opens. Select the font family, style, and point size from the lists. The preview area shows your current choice. Click <guibutton>OK</guibutton> to accept the change and update the desktop.</para>
<para>You can choose fonts for the following parts of the desktop:</para>
is a font-rendering technique that improves the quality of fonts at small
sizes and an at low screen resolutions. Select one of the options to specify
how to apply hinting your fonts.</para>
</listitem>
<listitem>
<para><guilabel>Subpixel order</guilabel>: Select one of the options
to specify the subpixel color order for your fonts. Use this option for LCD
or flat-screen displays.</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</sect4>
<!-- go to fonts folder no longer exists
<sect4 id="goscustdesk-83">
<title>Previewing a Font</title>
<indexterm>
<primary>fonts</primary>
<secondary>previewing</secondary>
</indexterm>
<para>A preview of a font shows the characters of a font at different sizes, as well as copyright and technical information. To preview a font, perform the following steps:</para>
<orderedlist>
<listitem>
<para>Open the <application>Appearance</application> preference tool by choosing <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Font</guimenuitem></menuchoice> in the top panel.</para>
</listitem>
<listitem><para>Click on <guibutton>Details</guibutton>.</para></listitem>
<listitem><para>Click on <guibutton>Go to font folder</guibutton>. The <guilabel>Fonts</guilabel> folder opens.</para></listitem>
<listitem>
<para>Open a font to display a preview.</para>
</listitem>
</orderedlist>
</sect4>
-->
<!-- go to fonts folder no longer exists
<sect4 id="goscustdesk-94">
<title>Adding a TrueType Font</title>
<para>To add a TrueType font to your system, perform the following steps:</para>
<orderedlist>
<listitem>
<para>Open the <application>Font</application> preference tool by choosing <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Font</guimenuitem></menuchoice> in the panel menubar.</para>
</listitem>
<listitem><para>Click on <guibutton>Details</guibutton>.</para></listitem>
<listitem><para>Click on <guibutton>Go to font folder</guibutton>. The <guilabel>Fonts</guilabel> folder opens.</para></listitem>
<listitem>
<para>Open a file manager window and select the TrueType font that
you want to add.</para>
</listitem>
<listitem>
<para>Copy the TrueType font file that you want to add to the <guilabel>Fonts</guilabel> folder.</para>
</listitem>
</orderedlist>
<warning><para>The new font will not appear in the <guilabel>Fonts</guilabel> folder until you next log in. You will need to relaunch applications for them to have access to the new font. These are known bugs in Gnome.</para></warning>
<tip><para>You can also open the <guilabel>Fonts</guilabel> folder by typing the following URI into <application>Nautilus</application> file manager's <link linkend="nautilus-open-location">Open Location dialog</link>: <command>fonts:///</command>.</para></tip>
</sect4>
-->
</sect3>
<sect3 id="prefs-menustoolbars">
<title>Interface Preferences</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<para>You can use the <guilabel>Interface</guilabel> tabbed section in the <application>Appearance</application> preference tool to customize the appearance
of menus, menubars, and toolbars for applications that are part of GNOME.</para>
<para>As you make changes to the settings, the preview display in the window updates. This allows you to see the changes if no application windows are currently open.</para>
<variablelist>
<varlistentry>
<term><guilabel>Show icons in menus</guilabel></term>
<listitem>
<para>Select this option to display an icon beside
items in application menus and the panel menu. Not all menu items have an icon.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Editable menu shortcut keys</guilabel></term>
<listitem><para>Selecting this option allows you to define new keyboard shortcuts for menu items.</para>
<para>To change an application shortcut key, open the menu, and with the mouse pointer on the menu item you wish to change, press the new combination of keys. To remove a shortcut key, press <keycap>Backspace</keycap> or <keycap>Delete</keycap>.</para>
<warning>
<para>When using this feature, you will not be warned if assigning a new shortcut key to a command also removes it from another command.</para>
<para>There is no way to restore the original, default keyboard shortcut for a command.</para>
<para>This feature does not maintain shortcuts that are normally common to all applications, such as <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> for Copy. This may lead to inconsistencies in your GNOME applications.</para>
the key to press-and-hold when you drag a window to move the window.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
<note>
<para>The position of the Control, Alt and Super keys on the keyboard can be modified in the
Keyboard Layout Options dialog, see <xref linkend="prefs-keyboard-layoutoptions"/>.
</para>
</note>
</sect2>
<sect2 id="prefs-screensaver">
<title>Screensaver Preferences</title>
<indexterm>
<primary>preference tools</primary>
<secondary>screensaver</secondary>
</indexterm>
<para>A <firstterm>screensaver</firstterm> displays moving images on your screen when your computer is not being used. Screensavers also help prevent older monitors being damaged by the same image being displayed for long periods of time. To stop the screensaver and return to the desktop, move the mouse or press a key on the keyboard.</para>
<para>Use the <application>Screensaver</application> preference tool to set the type of screensaver, the time before the screensaver starts, and whether to require a password to return to the desktop.</para>
<para>You can modify the following settings:</para>
<variablelist>
<varlistentry>
<term>Screensaver</term>
<listitem><para>Select the <guilabel>Screensaver theme</guilabel> from the list. A reduced version of the selected screensaver theme is shown. Press <guibutton>Preview</guibutton> to show the selected theme on the whole screen. During preview, use the arrow buttons at the top of the screen to go through the list of screensaver themes.</para>
<itemizedlist>
<listitem><para>The <guilabel>Blank screen</guilabel> theme displays no image and only shows a black screen.</para></listitem>
<listitem><para>The <guilabel>Random</guilabel> theme selects a screensaver to display from the list at random.</para></listitem>
</itemizedlist>
<para>Which screensavers are shown in the remainder of the list depends on your distributor or vendor.</para></listitem>
</varlistentry>
<varlistentry>
<term>Regard the computer as idle after...</term>
<listitem><para>Your computer becomes idle after this amount of time has passed with no input from you, such as moving the mouse or typing. This may affect power management (the monitor may power down for example) or instant messaging (chat applications may set your status as "away"). Use the slider to set the length of time in minutes or hours.</para></listitem>
</varlistentry>
<varlistentry>
<term>Activate screensaver when computer is idle</term>
<listitem><para>Select this option to have the screensaver start after the set length of time. </para></listitem>
</varlistentry>
<varlistentry>
<term>Lock screen when screensaver is active</term>
<listitem><para>When this option is selected, the screensaver will prompt you for your password when you try to return to the desktop. For more on locking your screen, see <xref linkend="lock-screen"/>.</para></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
<sect1 id="prefs-internet-and-network">
<title>Internet and Network</title>
<sect2 id="prefs-network-admin">
<title>Network Settings</title>
<para>The <application>Network Settings</application> allows you to specify the way your system connects to other computers and to internet.</para>
<para>You will be prompted for the administrator password when you start <application>Network Settings</application>. This is because the changes done with this tool will affect the whole system.</para>
<sect3 id="prefs-network-admin-getting-started">
<title>Getting started</title>
<para>The <application>Network Settings</application> main window contains four tabbed sections:</para>
<variablelist>
<varlistentry>
<term><guilabel>Connections</guilabel></term>
<listitem>
<para>Shows all network interfaces, it also allows you to modify their settings.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>General</guilabel></term>
<listitem>
<para>Allows you to modify your system host name and domain name.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>DNS</guilabel></term>
<listitem>
<para>Contains two sections, the <guilabel>DNS servers</guilabel> are what your computer use for resolving the IP addresses from the domain names. The <guilabel>search domains</guilabel> are the default domains in which your system will search any host when no domain is specified.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Hosts</guilabel></term>
<listitem>
<para>Shows the list of aliases for accessing other computers.</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
<sect3 id="prefs-network-admin-usage">
<title>Usage</title>
<sect4 id="tool-modify-connection">
<title>To modify a connection settings</title>
<para>In the <guilabel>Connections</guilabel> section, select the interface you want to modify and press the <guilabel>Properties</guilabel> button, depending on the interface type you will be able to modify different data.</para>
<variablelist>
<varlistentry>
<term>Ethernet and IRLAN interfaces</term>
<listitem>
<para>You can modify the way the interface is configured (DHCP or manually), if the interface is configured manually, you can also modify the interface IP address, netmask and gateway.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Wireless interfaces</term>
<listitem>
<para>You can modify the way the interface is configured (DHCP or manually), if the interface is configured manually, you can also modify the interface IP address, netmask and gateway, you can also modify the network name (ESSID) for this interface.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Parallel line interfaces</term>
<listitem>
<para>You can modify the interface IP address, as well as the remote IP address.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>PPP/Modem interfaces</term>
<listitem>
<para>You can modify the modem device, whether you want it to dial using tones or pulses, the modem volume, the phone number, the username and password that your ISP provided and other advanced settings for PPP.</para>
</listitem>
</varlistentry>
</variablelist>
</sect4>
<sect4>
<title>To activate or deactivate an interface</title>
<para>In the <guilabel>Connections</guilabel> section, enable or disable the checkbox beside the interface.</para>
</sect4>
<sect4>
<title>To change your host name and domain name</title>
<para>In the <guilabel>General</guilabel> section, change the hostname or domain name text boxes.</para>
</sect4>
<sect4>
<title>To add a new domain name server</title>
<para>In the <guilabel>DNS Servers</guilabel> section, press the <guilabel>Add</guilabel> button and fill in the new list row with the new domain name server.</para>
</sect4>
<sect4>
<title>To delete a domain name server</title>
<para>In the <guilabel>DNS Servers</guilabel> section, select a DNS IP address from the list and press the <guilabel>Delete</guilabel> button.</para>
</sect4>
<sect4>
<title>To add a new search domain</title>
<para>In the <guilabel>Search Domains</guilabel> section, press the <guilabel>Add</guilabel> button and fill in the new list row with the new search domain.</para>
</sect4>
<sect4>
<title>To delete a search domain</title>
<para>In the <guilabel>Search Domains</guilabel> section, select a search domain from the list and press the <guilabel>Delete</guilabel> button.</para>
</sect4>
<sect4>
<title>To add a new host alias</title>
<para>In the <guilabel>Hosts</guilabel> section, press the <guilabel>Add</guilabel> button and type an IP address and the aliases that will point to in the window that pops up.</para>
</sect4>
<sect4>
<title>To modify a host alias</title>
<para>In the <guilabel>Hosts</guilabel> section, select an alias, press the <guilabel>Properties</guilabel> button from the list and modify the alias settings in the window that pops up.</para>
</sect4>
<sect4>
<title>To delete a host alias</title>
<para>In the <guilabel>Hosts</guilabel> section, select an alias from the list and press the <guilabel>Delete</guilabel> button.</para>
</sect4>
<sect4 id="prefs-network-admin-add-new-profile">
<title>To save your current network configuration as a "Location"</title>
<para>Press the <guilabel>Add</guilabel> button besides the <guilabel>Locations</guilabel> menu, specify the location name in the window that pops up.</para>
</sect4>
<sect4>
<title>To delete a location</title>
<para>Press the <guilabel>Remove</guilabel> button besides the <guilabel>Locations</guilabel> menu, the selected profile will be deleted.</para>
</sect4>
<sect4>
<title>To switch to a location</title>
<para>Select one location from the <guilabel>Locations</guilabel> menu, all the configuration will be switched automatically to the chosen location.</para>
</sect4>
</sect3>
</sect2>
<sect2 id="prefs-networkproxy">
<title>Network Proxy Preferences</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<listitem><para>Enter the domain name or IP address of the proxy server to use when you
request a secure HTTP service. Enter the port number of the secure HTTP service on
the proxy server in the <guilabel>Port</guilabel> field.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>FTP proxy</guilabel></term>
<listitem><para>Enter the domain name or IP address of the proxy server to use when you
request an FTP service. Enter the port number of the FTP service on the proxy server in
the <guilabel>Port</guilabel> field.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Socks host</guilabel></term>
<listitem><para>Enter the domain name or IP address of the Socks host to use. Enter the port
number for the Socks protocol on the proxy server in the <guilabel>Port</guilabel> field.</para></listitem>
</varlistentry>
</variablelist>
</listitem></varlistentry>
<varlistentry><term><guilabel>Automatic proxy
configuration</guilabel></term><listitem><para>Select this option if you want to connect to the Internet through a proxy
server, and you want to configure the proxy server automatically.</para>
<para>Automatic proxy configuration works by means of a so-called PAC file, which your browser downloads from a web server. If you don't specify the URL for a PAC file in the <guilabel>Autoconfiguration URL</guilabel> entry, your browser
will try to locate one automatically.</para>
<variablelist>
<varlistentry><term><guilabel>Autoconfiguration
URL</guilabel></term><listitem><para>Enter the URL of a PAC file that contains the information required to configure the proxy
server automatically.</para></listitem></varlistentry>
</variablelist></listitem></varlistentry>
</variablelist>
<para>Set which hosts should not use the proxy in the <guilabel>Ignore Host List</guilabel> in the <guilabel>Ignored Hosts</guilabel> tabbed section. When you access these hosts, you will connect to the Internet directly without a proxy.</para>
</sect2>
<sect2 id="prefs-remotedesktop">
<title>Remote Desktop Preferences</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<para>The <application>Remote Desktop</application> preference tool enables you to share a GNOME Desktop session
between multiple users, and to set session-sharing preferences.</para>
<para><xref linkend="goscustdesk-TBL-91"/> lists the session-sharing preferences
that you can set. These preferences have a direct impact on the security of
your system.</para>
<table frame="topbot" id="goscustdesk-TBL-91">
<title>Session Sharing Preferences</title>
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="colspec18" colwidth="19.21*"/>
<colspec colname="colspec19" colwidth="46.79*"/>
<thead>
<row>
<entry colsep="0" rowsep="1">
<para>Dialog Element</para>
</entry>
<entry colsep="0" rowsep="1">
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Allow other
users to view your desktop</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Select this option to enable remote users to view your
session. All keyboard, pointer, and clipboard events from the remote user
are ignored.</para>
</entry>
</row>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Allow other
users to control your desktop</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Select this option to enable other to access and control
your session from a remote location.</para>
</entry>
</row>
<!--
<row>
<entry colname="colspec18" colsep="0" rowsep="0">
<para>
<guilabel>Users
can view your desktop using this command:</guilabel>
</para>
</entry>
<entry colname="colspec19" colsep="0" rowsep="0">
<para>Click on the command text to send it to
another user by email.</para>
</entry>
</row>
-->
<row>
<entry colname="colspec18" colsep="0" rowsep="0">
<para>
<guilabel>When
a user tries to view or control your desktop</guilabel>
</para>
</entry>
<entry colname="colspec19" colsep="0" rowsep="0">
<para>Select the following security
considerations when a user tries to view or control your session:<itemizedlist><listitem><para><guilabel>Ask you for confirmation:</guilabel> Select this
option if you want remote users to ask you for confirmation when they want
to share your session. This option enables you to be aware of other users
who connect to your session. You can also decide what time is suitable for
the remote user to connect to your session.</para></listitem><listitem><para><guilabel>Require the user to enter this password:</guilabel>
Select this option to authenticate the remote user if authentication is used.
This option provides an extra level of security.</para></listitem></itemizedlist></para>
</entry>
</row>
<row>
<entry colname="colspec18" colsep="0" rowsep="0">
<para>
<guilabel>Password</guilabel>
</para>
</entry>
<entry colname="colspec19" colsep="0" rowsep="0">
<para>Enter the password that the client who attempts to view or control your session
must enter.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
</sect1>
<sect1 id="prefs-hardware">
<title>Hardware</title>
<sect2 id="prefs-keyboard">
<title>Keyboard Preferences</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<anchor id="goscustperiph-2"/>
<indexterm>
<primary>preference tools</primary>
<secondary>Keyboard</secondary>
</indexterm>
<indexterm>
<primary>keyboard</primary>
<secondary>configuring
general preferences</secondary>
</indexterm>
<para>Use the <application>Keyboard</application> preference tool to modify the autorepeat preferences for
your keyboard, and to configure typing break settings. </para>
<!--
adds no information until each tab can be briefly summarized.
<para>You can set the preferences for the <application>Keyboard</application>
preference tool in the following functional areas:</para>
<itemizedlist>
<listitem>
<para>
<guilabel>Keyboard</guilabel>
</para>
</listitem>
<listitem>
<para>
<guilabel>Typing Break</guilabel>
</para>
</listitem>
<listitem>
<para>
<guilabel>Layouts</guilabel>
</para>
</listitem>
<listitem>
<para>
<guilabel>Layout Options</guilabel>
</para>
</listitem>
</itemizedlist>
-->
<para>To open the <link linkend="prefs-keyboard-a11y"><application>Keyboard <emphasis>Accessibility</emphasis></application> preference tool</link>, click the <guibutton>Accessibility</guibutton> button.</para>
<sect3 id="goscustdesk-40">
<title>Keyboard Preferences</title>
<para>Use the <guilabel>General</guilabel> tabbed section to set general
keyboard preferences.</para>
<para><xref linkend="goscustperiph-TBL-3"/> lists the keyboard preferences
that you can modify.</para>
<table frame="topbot" id="goscustperiph-TBL-3">
<title>Keyboard Preferences</title>
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="colspec18" colwidth="19.21*"/>
<colspec colname="colspec19" colwidth="46.79*"/>
<thead>
<row>
<entry colsep="0" rowsep="1">
<para>Dialog Element</para>
</entry>
<entry colsep="0" rowsep="1">
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Key presses
repeat when key is held down</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Select this option to enable keyboard repeat. If keyboard
repeat is enabled, when you press-and-hold a key, the action associated with
the key is performed repeatedly. For example, if you press-and-hold a character
<para>Use the slider to specify the speed at which the cursor
blinks in fields and text boxes.</para>
</entry>
</row>
<row>
<entry colname="colspec18" colsep="0" rowsep="0">
<para>
<guilabel>Type
to test settings</guilabel>
</para>
</entry>
<entry colname="colspec19" colsep="0" rowsep="0">
<para>The test area is an interactive interface so you can see
how the keyboard settings affect the display as you type. Type text in the
test area to test the effect of your settings.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect3>
<sect3 id="prefs-keyboard-layouts">
<title>Keyboard Layouts Preferences</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<anchor id="goscustdesk-100"/>
<para>Use the <guilabel>Layouts</guilabel> tabbed section to set your keyboard's language, and also the make and model of keyboard you are using.</para>
<para>This will allow GNOME to make use of special media keys on your keyboard, and to show the correct characters for your keyboard's language.</para>
<variablelist>
<varlistentry>
<term><guilabel>Keyboard model</guilabel></term>
<listitem><para>Use the browse button (labelled with the currently selected keyboard model) to choose another keyboard make and model.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Separate layout for each window</guilabel></term>
<listitem><para>
When this option is selected, each window has its own keyboard layout. Changing to a different layout will only affect the current window.</para>
<para>This allows you to to type with a Russian keyboard layout in a word processor, then switch to your web browser and type with an English keyboard layout, for example. </para></listitem>
<listitem><para>You can switch between selected layouts to change the characters your keyboard produces when you type. To add a layout, click <guibutton>Add</guibutton>. You can have up to four layouts. To remove a layout, select it and press <guibutton>Remove</guibutton>.</para>
<para>To switch between keyboard layouts, use the <ulink type="help" url="ghelp:gswitchit"><application>Keyboard Indicator</application> panel applet</ulink>. <!-- better link to the specific page, but not yet suitable for a direct link: ghelp:gswitchit?gswitchit-applet-switching --></para>
<para>To add a layout to the list of selected layouts, click the <guibutton>Add</guibutton> button. It opens a layout chooser dialog, which lets you select a layout by country or by language.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Click <guibutton>Reset to Defaults</guibutton> to restore all keyboard layout settings to their initial state for your system and locale.</para>
<para>Click the <guibutton>Layout Options</guibutton> button to open the <guilabel>Keyboard Layout Options</guilabel> dialog.</para>
</sect3>
<sect3 id="prefs-keyboard-layoutoptions">
<title>Keyboard Layout Options</title>
<!-- preserve id for backwards compatibility: 2.12 -->
<anchor id="goscustdesk-101"/>
<para>The <guilabel>Keyboard Layout Options</guilabel> dialog has options for the behaviour of keyboard modifier keys and certain shortcut options.</para>
<para>Expand each group label to show the available options. A label in boldface indicates that the options in the group have been changed from the default setting.</para>
<note><para>The options shown in this dialog depend on the X windowing system you are using. Not all the following options might be listed on your system, and not all the options shown might work on your system.</para></note>
<!-- the options of mystery!!!
for future reference, these are in
/etc/X11/xkb/rules/xorg.xml
-->
<variablelist>
<varlistentry>
<term><guilabel>Adding the EuroSign to certain keys</guilabel></term>
<listitem>
<para>Use these options to add the Euro currency symbol € to a key as a third-level character. To access this symbol, you must assign a <guilabel>third level chooser</guilabel>.</para>
This group of options allows you to assign the behaviour of Unix modifier keys Super, Meta, and Hyper to the <keycap>Alt</keycap> and <keycap>Windows</keycap> keys on your keyboard.
<para>The Compose key allows you to combine two keypresses to make a single character. This is used to create an accented character that might not be on your keyboard layout. For example, press the Compose key, then <keycap>'</keycap>, then <keycap>e</keycap> to obtain e-acute character. <!-- Translators: feel free to use an example suitable to your locale --></para>
<term><guilabel>Shift with numpad keys works as in MS Windows.</guilabel></term>
<listitem>
<para>With this option selected, using <keycap>Shift</keycap> with keys on the numerical pad when <keycap>NumLock</keycap> is off extends the current selection.</para>
<para>With this option unselected, use <keycap>Shift</keycap> with keys on the numerical pad to obtain the reverse of the current behaviour for that key. For example, when <keycap>NumLock</keycap> is off, the <keycap>8</keycap> key acts as an up-arrow. Press <keycombo><keycap>Shift</keycap><keycap>8</keycap></keycombo> to type an '8'.</para></listitem>
</varlistentry>
<varlistentry><term><guilabel>Special keys (Ctrl+Alt+<key>) handled in a server.</guilabel></term>
<listitem><para>Select this option to have certain keyboard shortcuts passed to the X windowing system instead of being handled by GNOME.</para></listitem>
<para>A <firstterm>third level</firstterm> key allows you to obtain a third character from a key, in the same way that pressing <keycap>Shift</keycap> with a key produces a different character to pressing the key alone.</para>
<para>Use this group to select a key you want to act as a third level modifier key.</para>
<para>Pressing the third-level key and <keycap>Shift</keycap> produces a fourth character from a key.</para>
<para>The third and fourth level characters for your keyboard layout are shown in the <ulink type="help" url="ghelp:gswitchit"><application>Keyboard Indicator</application></ulink> Layout View Window.</para>
<term><guilabel>Use keyboard LED to show alternative group.</guilabel></term>
<listitem>
<para>Use this option to specify that one of the light indicators on your keyboard should indicate when an alternative keyboard layout is in use.</para>
<note><para>The selected keyboard light will no longer indicate its standard function. For example, the Caps Lock light will not react to the <keycap>Caps Lock key</keycap>.</para></note>
<para>The <guilabel>Accessibility</guilabel> tabbed section allows you to set options such as filtering out accidental keypresses and using shortcut keys without having to hold down several keys at once. These features are also known as AccessX.</para>
<para>This section describes each of the preferences you can set. For a more task-oriented description of keyboard accessibility, see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
<para><xref linkend="goscustdesk-TBL-85"/> lists the accessibility preferences
that you can modify.</para>
<table frame="topbot" id="goscustdesk-TBL-85">
<title>Accessibility Preferences</title>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colwidth="50*"/>
<colspec colwidth="50*"/>
<thead>
<row rowsep="1">
<entry>
<para>Dialog Element</para>
</entry>
<entry>
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top">
<para>
<guilabel>Accessibility features can be toggled with keyboard shortcuts</guilabel>
</para>
</entry>
<entry valign="top">
<para>
Select this option to show an icon in the notification
area that offers quick access to accessibility features.
<para>Configure audio feedback for keyboard accessibility features.</para>
<para><xref linkend="goscustdesk-TBL-86"/> lists the audio feedback preferences
that you can modify.</para>
<table frame="topbot" id="goscustdesk-TBL-86">
<title>Audio Feedback Preferences</title>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colwidth="50*"/>
<colspec colwidth="50*"/>
<thead>
<row rowsep="1">
<entry>
<para>Dialog Element</para>
</entry>
<entry>
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top">
<para>
<guilabel>Beep when accessibility features are turned on or off</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option for an audible indication when a feature
such as sticky keys or slow keys is activated, or deactivated.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Beep when a toggle key is pressed</guilabel>
</para>
<indexterm>
<primary>accessibility</primary>
<secondary>toggle keys</secondary>
</indexterm>
</entry>
<entry valign="top">
<para>Select this option for an audible indication of a toggle keypress.
You hear one beep when a toggle key is turned on. You hear two
beeps when a toggle key is turned off.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Beep when a modifier key is pressed</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option for an audible indication when you
press a modifier key.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Beep when a key is pressed</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option for an audible indication when
a key is pressed.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Beep when a key is accepted</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option for an audible indication when
a key is accepted.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Beep when a key is rejected</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option for an audible indication when
a key is rejected.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect3>
<sect3>
<title>Mouse Keys Preferences</title>
<anchor id="goscustaccess-10"/>
<para>The options in the <guilabel>Mouse Keys</guilabel> tabbed section
let you configure the keyboard as a substitute for the mouse.</para>
<para><xref linkend="goscustdesk-TBL-88"/> lists the mouse keys preferences
that you can modify.</para>
<table frame="topbot" id="goscustdesk-TBL-88">
<title>Typing Break Preferences</title>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colwidth="50*"/>
<colspec colwidth="50*"/>
<thead>
<row rowsep="1">
<entry>
<para>Dialog Element</para>
</entry>
<entry>
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top">
<para>
<guilabel>Pointer can be controlled using the keypad</guilabel>
</para>
<indexterm>
<primary>accessibility</primary>
<secondary>mouse keys</secondary>
</indexterm>
</entry>
<entry valign="top">
<para>Select this option to make the numeric keypad emulate mouse actions. The list of keys and their equivalences is in the <citetitle>GNOME Desktop Accessibility Guide</citetitle> under the heading <ulink type="help" url="ghelp:gnome-access-guide?dtconfig-14"><citetitle>To Enable the Keyboard to Emulate the Mouse</citetitle></ulink>.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Acceleration</guilabel>
</para>
</entry>
<entry valign="top">
<para>Use the slider to specify how long it takes the pointer to accelerate to maximum speed.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Speed</guilabel>
</para>
</entry>
<entry valign="top">
<para>Use the slider
to specify the maximum speed that the pointer moves across
the screen.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Delay</guilabel>
</para>
</entry>
<entry valign="top">
<para>Use the slider to specify the period of time that must pass
after a keypress before the pointer moves.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect3>
<sect3 id="goscustdesk-86">
<title>Typing Break Preferences</title>
<para>Configure the Typing Break Preferences to make GNOME remind you to rest after you have been using the keyboard and mouse for a long time. During a Typing Break, the screen will be locked.</para>
<para><xref linkend="goscustdesk-TBL-87"/> lists the typing break preferences
that you can modify.</para>
<table frame="topbot" id="goscustdesk-TBL-87">
<title>Typing Break Preferences</title>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colwidth="50*"/>
<colspec colwidth="50*"/>
<thead>
<row rowsep="1">
<entry>
<para>Dialog Element</para>
</entry>
<entry>
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top">
<para>
<guilabel>Lock screen to enforce typing break</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option to
lock the screen when you are due a typing break.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Work interval lasts</guilabel>
</para>
</entry>
<entry valign="top">
<para>Use the spin box to specify how long you can work
before a typing break occurs.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Break interval lasts</guilabel>
</para>
</entry>
<entry valign="top">
<para>Use the spin box to specify the length of your typing
breaks.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Allow postponing of breaks</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option if you want to be able to postpone
typing breaks.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
<note><para>
If you stop using the keyboard and mouse for a length of time equal to the <guilabel>Break interval</guilabel> setting, the current work interval will be reset.
</para></note>
</sect3>
</sect2>
<sect2 id="prefs-mouse">
<title>Mouse Preferences</title>
<!-- Maintained for 2.8 compatibility -->
<anchor id="goscustperiph-5"/>
<indexterm>
<primary>preference tools</primary>
<secondary>Mouse</secondary>
</indexterm>
<indexterm>
<primary>mouse</primary>
<secondary>configuring</secondary>
</indexterm>
<para>With the <application>Mouse</application> preference tool
you can:</para>
<itemizedlist>
<listitem>
<para>configure your mouse for right-hand use or for left-hand use,</para>
</listitem>
<listitem>
<para>specify the speed and sensitivity of mouse movement,</para>
<para>Use the <guilabel>General</guilabel> tabbed section to specify whether
the mouse buttons are configured for left-hand or right-hand use and configure
the speed and sensitivity of your mouse.</para>
<para><xref linkend="goscustperiph-TBL-6"/> lists the general mouse preferences
that you can modify.</para>
<!-- convert to variablelist -->
<table frame="topbot" id="goscustperiph-TBL-6">
<title>Mouse Button Preferences</title>
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="colspec18" colwidth="19.21*"/>
<colspec colname="colspec19" colwidth="46.79*"/>
<thead>
<row>
<entry colsep="0" rowsep="1">
<para>Dialog Element</para>
</entry>
<entry colsep="0" rowsep="1">
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Right-handed</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Select this option to configure your mouse for right-hand use. When you configure your mouse for right-hand use, the left mouse button is the primary button and the right mouse button is the secondary button.</para>
</entry>
</row>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Left-handed</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Select this option to configure your mouse for left-hand use. When you configure
your mouse for left-hand use, the functions of the left mouse button and the
right mouse button are swapped.</para>
</entry>
</row>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Show position of pointer when the Control key is pressed</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Select this option to enable a mouse pointer animation
when you press and release the Control key. This feature can assist
you to locate the mouse pointer.</para>
<note>
<para>The position of the Control key on the keyboard can be
modified in the Keyboard Layout Options dialog, see
<para>Use the slider to specify the speed at which your
mouse pointer moves on your screen when you move your mouse.</para>
</entry>
</row>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Sensitivity</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Use the slider to specify how sensitive your mouse
pointer is to movements of your mouse.</para>
</entry>
</row>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Threshold</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Use the slider to specify the distance that you
must move an item before the move action is interpreted as a drag-and-drop
action.</para>
</entry>
</row>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Timeout</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Use the slider to specify
the amount of time that can pass between clicks when you double-click. If
the interval between the first and second clicks exceeds the time that is
specified here, the action is not interpreted as a double-click. </para>
<para>Use the light bulb icon to check double-click sensitivity: the light will light up briefly for a click, but stay lit for a double-click.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect3>
<sect3 id="goscustdesk-53">
<title>Mouse Accessibility Preferences</title>
<para>Use the <guilabel>Accessibility</guilabel> tabbed section to configure
accessibility features that can help people who have difficulty with exact positioning of the pointer or with pressing the mouse buttons:</para>
<itemizedlist>
<listitem>
<para>
Open a contextual menu by clicking and holding the primary mouse button; this is useful for users that can manipulate only one button.
</para>
</listitem>
<listitem>
<para>
Perform different types of mouse button click by software; this useful for users that are not able to manipulate any buttons. The types of click that can be performed are:
<variablelist>
<varlistentry>
<term>Single click</term>
<listitem>
<para>
A single click of the primary mouse button
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Double click</term>
<listitem>
<para>
A double click of the primary mouse button
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Drag click</term>
<listitem>
<para>
A click that begins a drag operation
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Secondary click</term>
<listitem>
<para>
A single click of the secondary mouse button
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</itemizedlist>
<para><xref linkend="goscustdesk-TBL-47"/> lists the mouse accessibility preferences
that you can modify:</para>
<table frame="topbot" id="goscustdesk-TBL-47">
<title>Mouse Motion Preferences</title>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colwidth="30.10*"/>
<colspec colwidth="69.90*"/>
<thead>
<row rowsep="1">
<entry>
<para>Dialog Element</para>
</entry>
<entry>
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Trigger secondary click by holding down the primary button</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>Select this option to enable simulated secondary clicks by pressing the primary mouse button for an extended time.</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Delay</guilabel> slider in the <guilabel>Simulated Secondary Click</guilabel> section
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>Use the slider to specify how long the primary button must be pressed to simulate a secondary click.</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Initiate click when stopping pointer movement</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>Select this option to enable automatic clicks when the mouse stops. Use the additional preferences in the <guilabel>Dwell Click</guilabel> section to configure how the type of click is chosen.</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Delay</guilabel> slider in the <guilabel>Dwell Click</guilabel> section
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>Use the slider to specify how long the pointer must remain at rest before an automatic click will be triggered.</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Motion threshold</guilabel> slider
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>Use the slider to specify how much the pointer may move to still be considered at rest.</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Choose type of click beforehand</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>Select this option to pick the type of click to perform
from a window or panel applet.</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Show click type window</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>
When this option is enabled, the different types of click (single click, double click, drag click or secondary click) can be selected in a window.</para>
<note><para>The <guilabel>Dwell Click</guilabel> panel applet can
be used instead of the window.</para></note>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Choose type of click with mouse gestures</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>Select this option to pick the type of click by moving the mouse in a certain direction. The four combo boxes below this option allow to assign directions to the different types of click. Note that each direction can be used only for one type of click.</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Single click</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>
Choose the direction to trigger a single click.
</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Dpuble click</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>
Choose the direction to trigger a double click.
</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Drag click</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>
Choose the direction to trigger a drag click.
</para>
</entry>
</row>
<row>
<entry rowsep="0" colsep="0" valign="top">
<para>
<guilabel>Secondary click</guilabel>
</para>
</entry>
<entry rowsep="0" colsep="0" valign="top">
<para>
Choose the direction to trigger a secondary click.
</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect3>
</sect2>
<sect2 id="goscustdesk-70">
<title>Display Preferences</title>
<indexterm>
<primary>preference tools</primary>
<secondary>Display</secondary>
</indexterm>
<para>Use the <application>Display</application>
preference tool to configure the monitors that your computer uses.</para>
<note><para>On most laptop keyboards, you can use the key combination
<keycombo><keycap>Fn</keycap><keycap>F7</keycap></keycombo> to cycle between
several typical monitor configurations without starting the <application>Display</application> preference tool.
</para></note>
<para>You can drag and move the graphical representations of the monitors in
the upper part of the window to arrange how they are connected to form your
desktop area. Note that the application displays small 'stickers' in the top
left corner of each monitor to help you identify which rectangle corresponds
to which monitor.</para>
<note><para>In contrast to most other preference tools, changes you make in
the <application>Display</application> preference tool don't take effect until
you click the <guibutton>Apply</guibutton> button, and will revert to their
previous settings unless you confirm the changes. This is a precaution to
prevent bad display settings from rendering your computer unusable.</para></note>
<para><xref linkend="goscustdesk-TBL-72"/> lists the display preferences that
you can modify for the currently selected monitor. The currently selected
monitor is the one whose graphical representation has a bold black outline.
It is also indicated by the background color of the section label.
</para>
<table frame="topbot" id="goscustdesk-TBL-72">
<title>Display Preferences</title>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colname="colspec0" colwidth="50*"/>
<colspec colname="colspec1" colwidth="50*"/>
<thead>
<row rowsep="1">
<entry>
<para>Dialog Element</para>
</entry>
<entry>
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top">
<para>
<guilabel>Mirror Screens</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option to have all monitors show the whole desktop.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guibutton>Detect Monitors</guibutton>
</para>
</entry>
<entry valign="top">
<para>Use this button to make your desktop notice newly plugged
in or unplugged monitors. This is necessary, since it would
cost too much energy to constantly check for these changes.
</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Resolution</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select the resolution to use for the currently selected
monitor from the drop-down list. <emphasis>Resolution</emphasis>
refers to the pixel dimensions of the screen. A larger
resolution means that more things fit on the screen, but
everything will be smaller.
</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Refresh rate</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select the refresh rate to use for the currently
selected monitor from the drop-down list. The <emphasis>refresh
rate</emphasis> determines how often the computer redraws the
screen. A too low refresh rate (below 60) makes the monitor
flicker and can cause discomfort to your eyes. This is less
of a problem on lcd displays.
</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Rotation</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select the rotation for the currently selected monitor. This option may not be supported on all graphics cards.</para>
</entry>
</row>
<row>
<entry valign="top">
<para>
<guilabel>Show displays in panel</guilabel>
</para>
</entry>
<entry valign="top">
<para>Select this option to show an icon in the notification area
that allows you to quickly change the rotation.</para>
you to control when the GNOME sound server starts. You can also specify which
sounds to play when particular events occur.</para>
<para>You can customize the settings for the <application>Sound</application>
preference tool in the following functional areas:</para>
<itemizedlist>
<listitem>
<para>
<guilabel>General</guilabel>
</para>
</listitem>
<listitem>
<para>
<guilabel>Sound Events</guilabel>
</para>
</listitem>
<listitem>
<para>
<guilabel>System Bell</guilabel>
</para>
</listitem>
</itemizedlist>
<sect3 id="goscustmulti-3">
<title>General Sound Preferences</title>
<para>Use the <guilabel>General</guilabel> tabbed section of the <application>Sound</application> preference tool to specify when to launch the GNOME sound
server. You can also enable sound event functions.</para>
<para><xref linkend="goscustmulti-TBL-4"/> lists the general sound preferences
that you can modify.</para>
<table frame="topbot" id="goscustmulti-TBL-4">
<title>General Sound Preferences</title>
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="colspec18" colwidth="19.21*"/>
<colspec colname="colspec19" colwidth="46.79*"/>
<thead>
<row>
<entry colsep="0" rowsep="1">
<para>Dialog Element</para>
</entry>
<entry colsep="0" rowsep="1">
<para>Description</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Enable sound
server startup</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Select this option to start the GNOME sound server when you start a GNOME
session. When the sound server is active, the GNOME Desktop can play sounds.</para>
</entry>
</row>
<row>
<entry colsep="0" rowsep="0" valign="top">
<para>
<guilabel>Sounds for
events</guilabel>
</para>
</entry>
<entry colsep="0" rowsep="0" valign="top">
<para>Select this option to play sounds when particular events occur in the GNOME
Desktop. You can select this option only if the <guilabel>Enable sound server
startup</guilabel> option is selected.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect3>
<sect3 id="goscustdesk-48">
<title>Sound Event Preferences</title>
<para>Use the <guilabel>Sound Events</guilabel> tabbed section of the <application>Sound</application> preference tool to associate particular sounds with particular
events. </para>
<note>
<para>You must select the <guilabel>Enable sound server startup</guilabel>
option, and the <guilabel>Sounds for events</guilabel> option before you can
access the <guilabel>Sound Events</guilabel> tabbed section.</para>
</note>
<para><xref linkend="goscustmulti-TBL-6"/> lists the sound events preferences
a sound with an event, select the event in the <guilabel>Sounds</guilabel>
table. Enter the name of the sound file that you want to associate with the
selected event in the drop-down combination box. Alternatively, click <guibutton>Browse </guibutton> to display a <guilabel>Select sound file</guilabel> dialog.
Use the dialog to specify the sound file that you want to associate with the
selected event.</para>
<note>
<para>You can only associate sound files in <filename>.wav</filename> format with events.</para>
<para>Use this table to manage non-session-managed
startup applications as follows:</para>
<itemizedlist>
<listitem>
<para>To add a startup application, click on the <guibutton>Add</guibutton> button. The <guilabel>Add Startup Program</guilabel> dialog is
displayed. Enter the command to start the application in the <guilabel>Startup
Command</guilabel> field. </para>
<para>If you specify more than one startup application, use the <guilabel>Priority</guilabel> spin box to specify the startup order of the each application.
The startup order is the order in which you want the startup applications
to start.</para>
</listitem>
<listitem>
<para>To edit a startup application, select the startup application,
then click on the <guibutton>Edit</guibutton> button. The <guilabel>Edit Startup
Program</guilabel> dialog is displayed. Use the dialog to modify the command
and the startup order for the startup application.</para>
</listitem>
<listitem>
<para>To delete a startup application, select the startup application,
then click on the <guilabel>Delete</guilabel> button.</para>
